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SunPainf 1.0 


If you have any problems installing or using SunPaint call Sun Microsystems at 
the hotline number listed on the last page for your service region. When you 
call, have the following information ready to give to the service dispatcher: 

□ Your system’s model number and serial number. 

□ The Sun operating system (SunOS™) release number. To see the SunOS 
release number, type: cat /etc/motd 

□ The SunPaint release number. If SunPaint is currently installed on your 
machine, you can see the release number in the frame stripe of the SunPaint 
product. 

You can also send questions by electronic mail to sun! hotline. Be sure your 
mail message includes your name, company, and phone number, and the infor¬ 
mation listed above. 

If you have questions about Sun’s support services or your shipment, call your 
sales representative. 

SunPaint 1.0 can be used on a Sun-2™ or Sun-3™ workstation running SunOS 
3.4, SunOS 3.5, or SunOS 4.0 


None of the problems listed here will cause loss of data, and are, therefore, not 
very serious. Each user should make note of the “buglets” below and take the 
recommended precautions or follow the workaround procedures listed. In both 
this section and the product specific section, the problems are listed in decreas¬ 
ing order of severity. 

The Sun logo. Sun Microsystems, and Sun Workstaticm are registered trademarks of Sun Microsystems, Inc. 
Sun, Sun-2, Sun-3, Sun-4, Sun386i, Suninstall, SunOS, SunView, NFS, NeWS, and SPARC are trademarks of 
Sun Microsystems, Inc. 

SunWrite, SunPaint, and SunDraw are trademarks of Sun Microsystems, Inc. 

UNIX is a registered trademark of AT&T. 

PostScript is a registered trademark of Adobe Systems, Inc. 

All other products or services mentioned in this document are identified by the trademarks or service marks of 
their respective companies or organizations. 
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Requesting Several Passwords 


Licensing, Passwords 


Operating System Upgrades 


Heterogenous Environments 


Swap Space 


Screen Capture 


Printing 



Getting several passwords may require a long time on the phone. To avoid that, 
you can contact the dispatcher at your local support center. The dispatcher will 
provide you with an e-mail address, a fax number, or a telex number at Sun. You 
should send Sun: 

□ Your sales order number. 

□ The hostids of the machines involved. 

□ Your address information (Company, address, fax (if available), or e-mail 
address). 

The passwords will be sent to you via the medium you request. 

Chapter 6 of the installation guide states that only domestic users need pass¬ 
words. This is not the case. All users must obtain a password to use all three 
STAGE products. Users outside of the United States should call their support 
center (see the list of phone numbers on the last page of this document), and 
users inside of the U.S. should call (800) USA-4SUN. 

If at any point you upgrade your server and client machines to a new version of 
the operating system, you will lose two files: /etc/licenses and 
/etc/sundesk. 

Workaround: Reinstall these files according to the STAGE Installation Guide 
after an operating system upgrade. 

If STAGE is installed in the /usr partition on a heterogenous file server (for 
example: Sun3 server, Sun2 client) then the file /etc/sundesk will contain 
/usr.MC68020/sundesk. Then, if Sun2 clients copy this file to their sys¬ 
tem the products will be unable to locate their support files and fonts. 
Workaround: Delete the MC680x0 extension. 

The proper amount of swap space is very important when using the STAGE pro¬ 
ducts. If your machine runs out of swap space, while using one of the STAGE 
applications, the program may exit ungracefully and you may lose any changes 
made since the last time you saved. 

Workaround: Make sure that you or your system administrator set up your 
machine with the recommended amount of swap space. See the STAGE Installa¬ 
tion Guide for more complete information about swap space requirements. 

In the screen capture facility, a large amount of memory is used to hold the 
image. This memory is not deallocated properly. Successive screen captures can 
use up available memory space. The end result can be that the application can 
use up all the swap space that you have on your machine. 

Workaround: After you capture large images five or six times, you should save 
your current document or picture and restart the application. 

If you do not have write permission in /usr/tmp (this may occur if you have it 
mounted on a read-only file system), your print jobs will appear to print, but fail. 
Workaround: Change the write permissions in /usr/tmp by remounting read- 
write, creating a link, or print to a file and Ipr that file. 
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Printing Text in SunWrite and Note that for SunDraw and SunWrite only the following fonts are recognized on 
SunDraw a standard LaserWriter: Helvetica, Times Roman, Courier, and Symbol. The 

Zapf Dingbats or Symbols characters are not supported by the standard Laser¬ 
Writer. When you try to print unsupported fonts, the printer will use a default 
font (usually courier) and will print an error message across the page. 

If you want to check which fonts are available on your LaserWriter, run the 
PostScript program $SUNDESK/sunwrite/print_font .ps or 
$SUNDESK/sundraw/print_f ont. ps (they are the same program) with 
Ipr . It wiU print a page listing all fonts available on your printer. 

All of Sunpaint’s fonts wiU print on all printers. 

Waiting for Clipboard Access There is no access lock on the clipboard, so it is possible that one STAGE appli¬ 

cation can try to read the clipboard before another has finished accessing it. This 
can lead to improper data. 

Workaround: Always wait until the first application has accessed the clipboard 
before using it with the second. You can tell when an application is busy by the 
shape of the pointer. The pointer will look like a stop watch when busy, and will 
be an arrow when it has completed the operation. 

Clipboard Ownership If the clipboard is owned by one user, and a different user executes a command 

that requires writing to the clipboard, the clipboard may not be writable by the 
second user, and thus the command will fail. 

Workaround: If a screen capture, copy, or cut fails with an error message 
Can't open clipboard, remove the clipboard files in /tmp. 

Scrollbar Menus The menus that are attached to the horizontal and vertical scrollbars contain 

menu items that do not behave as expected. There are three menu items: Here 
to Top, Top to Here, and Last Position. The first two items scroll to a random 
location. The last position menu item works properly, and will toggle the scroll 
position between the last two scroU locations. 

Workaround: Explicitly scroll using the scroll elevator with the LEFT mouse but¬ 
ton. 

NOTE This only affects the RIGHT mouse button operations. 

Expose!Hide Key The [LI] key on the keyboard does not toggle the position of the product window 

in relation to other windows. If the mouse pointer is in the head panel of the 
tool, then the expose key works as expected. However, if the mouse pointer is on 
the frame boundary or in the canvas, the (TSl key will only expose the product, it 
will not hide it. 

Workaround: Only use the [TI] key with the mouse pointer in the head panel. 

31110 and 3160 Color Frame If one of the STAGE products is displayed in front of a color window, the color 
Buffers panel will show through the header and frame. 

Workaround: Select refresh from the frame menu when this occurs. 
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Menus When there is not enough room between the mouse position and the right edge of 

the screen, you will be unable to display a menu. 

Workaround: Move the window or the mouse pointer away from the right edge 
of the screen, and press the RIGHT mouse button again. 

Installation Guide The wording of the example installation is incorrect. On page 33 of the STAGE 

Installation Guide at the beginning of the second grey box, it states: 

Call Sun at (800) 872-4786. When the operator answers, tell 
him or her that you wish a password for SunWrite. 

It should read: 

Call your local SUN support center. When the operator answers 
tell him or her that you wish a password for SunWrite. 
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Known Problems with 
SunPaint 

Narrow Spacing in Helvetica 
Text 


Region Nudging 


Undo and Region Nudging 


Text After Erasing 


Loading Large Regions 


Filling Single Pixels with White 


Single-Pixel Brush Accidentally 
Doubles 


Erasing 


Corners of Oblique Text 
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The spacing in Helvetica text is one pixel too narrow, so that adjacent letters 
seem to touch. For example,^ a series of adjacent semi-colons looks like an odd 
line. 

Workaround: Separate each letter with a space. 

Regardless of what transparency level you are using, the nudge action works as a 
copy region on the first nudge (that is, it does not cut a blank spot underneath the 
region). 

Although the region nudge buttons are enabled for freeform regions, the nudge 
buttons do nothing. The other region buttons work as expected. 

If you nudge a region right after defining it, undo removes the region handles and 
leaves the region pixels where they are. When you nudge a region that was first 
‘moved’ or ‘copied’, undo takes the region back to its starting location. 

After typing in text, if you erase part of your picture and then you go back to text 
mode, if you use any of the following text options: block, underline, right- 
oblique, or left-oblique; the text will appear as a solid black bar. 

Loading a region larger than the canvas size causes an error message to appear 
specifying how large the canvas must be in order to load. This number must be 
increased by 3 pixels in both the vertical and horizontal directions in order to 
load the desired region. 

If you try to use white fill to do single-pixel cleanup you may erase a couple of 
extra pixels bounding the pixel you touch. 

Workaround: Redraw the lost pixels using the single pixel brush, and the black 
pattern. 

After you select any pattern, black, white or gray fill, all of the foUowing modes 
become double-pixel width even when you use the single-pixel brush: lines, free¬ 
hand, parallelogram, bezier, polygon, and triangle. This also means that rectan¬ 
gles and parallelograms overlap by one-pixel in the left comer after pattern selec¬ 
tion. You can only see this phenomenon when looking at the edits while viewing 
your changes through the magnifier. 

Workaround: To get back to single-pixel brush, you must save your edits, exit 
SunPaint, and start it up again. 

The longest vertical brush disappears when used for erasing. This does not occur 
with any of the other brushes. 

In oblique text the top comers of adjacent letters disappear due to the overlap¬ 
ping white space. 

Workaround: Using the text in transparent mode eliminates the problem. 
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DcMTumentation Errata 
and Additions 

Demo Files In the directory $SUNDESK/demo/ sunpaint you will find a few demonstra¬ 

tion files that can be read into SunPaint. 
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Notes to Beta Site System if the stage products were installed at your site for beta testing, you should per- 

Administrators form the following operations before installing any of the new versions 

SunWrite, SunPaint, or SunDraw. 

1. Remove the entire installation directory $SUNDESK. Also, remove any 
links that you may have created to this directory or its files. 

2. Update your . sunwrite, . sundraw and . sunpaint files with the 
new versions that appear on each of the release tapes. 

3. If you install the new version in a different directory, you must do the fol¬ 
lowing: 

□ Change your $SUNDESK variable to point to the new location, 
o Update your path entry to reflect the new bin directory. 

□ Change the entry in the /etc/sundesk file on each client machine to 
point to the new installation directory. 

4. The Beta passwords for SunWrite, SunPaint and SunDraw are no longer 
valid, and they no longer share passwords. As root, you must remove the 

S unWrite entry in the /etc/licenses file on all of your client machines. 
Then, you must obtain one password per product per machine. Follow the 
instructions in the Installation Guide to obtain and install new passwords for 
aU three products. 

NOTE The file formats for SunWrite, SunPaint, and SunDraw have not changed; so 

your existing documents and pictures can be loaded into the new versions of the 
STAGE products. 
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Notes 
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Sun Hotline Numbers 

Sun Customers throughout the world have service hotiines available for both 

software and hardware support questions. The service hotlines are shown below. 
If your country is not shown in the table, please phone your local Sun sales 
office. 


Country 

Service Region 

Hotline Number 

Hong Kong 

Sun Hong Kong 

(5) 865-1688 

Japan 

C. Itoh Data Systems 

(3)497-4746 


Nihon Sun 

(3) 221-7021 


Australia 



Country 

Service Region 

Hotline Number 


Australia 

Sun Australia 

(2)436-4699 

Europe 


Country 

Service Region 

Hotline Number 


France 

Paris 

Sun Microsystems France SA 

14630 0231 

Germany 

Munich 

Sun Microsystems GmbH 

(49)89 4600 8321 

The Netherlands 

Soest 

Sun Microsystems Nederland BV 

2155 24888 

Sweden 

Solna 

Sun Microsystems AB 

8 764 78 10 

Switzerland 

Zurich 

Sun Microsystems (Schweiz) AG 

1 828 9555 

United Kingdom 
Customer Service 

Sun Microsystems UK Ltd 

Albany Park 

(44) 276 691974 

Other Europe 


(44) 276 51440 
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North American Continent 


Country 

Service Region 

Hotline Number 

Central Region: 

Toronto 

(416) All-ms 

Eastern Region: 

Montreal 

(514) 738-4885 

Western Region: 

Calgary 

(403) 262-6722 

United States 

All, 

including Puerto Rico 

1-800-USA-4-SUN 

(1-800-872-4786) 


All Other Countries 


Country 

Service Region 

Hotline Number 

Countries Not 
Listed 

AU countries outside the USA, and 
Northern Africa 

(415) 496-6119 
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825-1107-02 


Part Number 
800 - 2228-10 
800 - 2229-10 
800 - 2227-10 
800 - 2226-10 


Description 

Installation Guide P-W-D 
SunPaint Quick Reference Guide 
SunPaint User’s Guide 
SunPaint Tutorial 


A sun 

XT microsystems 


Part No. 800-2232-10 
Revision A 




